Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Miguelcds/App_AsignadorZonasBilbao/llms.txt

Use this file to discover all available pages before exploring further.

Asignador de Zonas de Bilbao is a Progressive Web App (PWA). This means it is installable on your device and works fully offline after the first visit.

What PWA means for this app

  • Installable — you can add it to your home screen or desktop like a native app.
  • Offline-capable — once loaded, the app works without an internet connection.
  • No server needed — all Excel processing happens in the browser. No data leaves your device.

How offline works

The app uses a cache-first strategy. On the first load, the Service Worker pre-caches every asset listed in the ASSETS array in sw.js:
const ASSETS = [
    './index.html',
    './manifest.json',
    './css/styles.css',
    './js/data.js',
    './js/app.js',
    './assets/bilbo.jpg',
    './assets/images.png',
    './assets/icono192x192.png',
    './assets/icono512x512.png',
    'https://cdn.sheetjs.com/xlsx-0.19.3/package/dist/xlsx.full.min.js',
    'https://fonts.googleapis.com/css2?family=Bebas+Neue&family=DM+Sans:wght@300;400;500;600&display=swap',
];
This includes the SheetJS Excel library (loaded from CDN) and Google Fonts — both are cached on first load so they are available offline. On every subsequent request, the Service Worker returns the cached version immediately. If a resource is not in the cache (which should not happen under normal conditions), it falls back to the network.
All Excel file processing is entirely client-side. The files you upload are never sent to any server.

Installing the app

1

Open the app in Chrome

Navigate to the app URL in Chrome on Android.
2

Tap the install prompt

Chrome displays an Add to Home screen banner at the bottom of the screen. Tap it.
3

Confirm installation

Tap Add. The app appears on your home screen with the name Zonas Bilbao and the app icon.

Manifest configuration

The PWA metadata is defined in manifest.json:
{
  "name": "Asignador de Zonas de Bilbao",
  "short_name": "Zonas Bilbao",
  "display": "standalone",
  "background_color": "#07070d",
  "theme_color": "#07070d",
  "icons": [
    { "src": "assets/icono192x192.png", "sizes": "192x192", "type": "image/png" },
    { "src": "assets/icono512x512.png", "sizes": "512x512", "type": "image/png" }
  ]
}
  • display: standalone — the app opens without browser chrome (no address bar).
  • short_name — used as the label under the home screen icon.
  • theme_color — controls the status bar and title bar color on mobile.

Browser compatibility

BrowserPWA installOffline support
Chrome / EdgeFull supportFull support
FirefoxNo install promptFull offline support
Safari / iOSVia Share menuPartial (varies by iOS version)
The Service Worker requires HTTPS in production. It works on localhost for development, but will not register on plain HTTP or file:// URLs.